====== pageStop() ======

''void **pageStop**()''

Die Funktion verhindert, dass weitere Inhalte der Fragebogen-Seite angezeigt bzw. ausgeführt werden.

Wenn innerhalb eines PHP-Code Elements im Fragebogen noch weitere Befehl folgen, so unterbindet ''pageStop()'' auch deren Ausführung.


===== Beispiel =====

Im folgenden Beispiel wird ''pageStop()'' im Zusammenspiel mit einem Screen-Out Filter verwendet. So können auf der Screen-Out Seite noch weitere Inhalte (z.B. Fragen) platziert werden.

Der Filter zeigt Personen, die bei Frage SK01 mit dem Wert 1 (jünger als 18) oder 7 (älter als 65) geantwortet haben, den Textbaustein "screenout" und blendet den Weiter- und Zurück-Knopf aus, sodass das Interview faktisch beendet wird.

Unter diesem PHP-Code können weitere Elemente (Fragen, PHP-Code, ...) auf der Seite platziert werden, auch per "Hineinziehen" (Drag & Drop) in die Fragebogen-Seite. Diese Elemente werden den abgewiesenen Teilnehmer dank ''pageStop()'' nicht mehr angezeigt.

<code php>
if ((value('SK01') == 1) or (value('SK01') == 7)) {
  text('screenout');
  buttonHide();
  pageStop();
}
</code>

Ohne ''pageStop()'' müsste man die weiteren Element in den Filter aufnehmen...

<code php>
if ((value('SK01') == 1) or (value('SK01') == 7)) {
  text('screenout');
  buttonHide();
} else {
  question('AB01');
  question('AB02');
}
</code>

... oder man würde die Inhalte auf eine zusätzliche Seite (nach der aktuellen) legen, sodass auf der Seite keine Inhalte mehr folgen.


<code php>
if ((value('SK01') == 1) or (value('SK01') == 7)) {
  text('screenout');
  buttonHide();
} else {
  goToPage('next');
}
</code>